---
title: Gong
sidebarTitle: Gong
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/gong/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/gong/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ✅ Not required | Free, self-signup for a [Gong account](https://www.gong.io/free-trial/). |
| Paid test account | ✅ Not required | Free trial account can be used for testing. |
| Partnership | ✅ Not required | |
| App review | ⚠️ Required for OAuth | Only required for OAuth apps published to the Gong Collective. Not required for Basic Auth. |
| Security audit | ✅ Not required | |


## Setup guide

Gong offers two authentication methods: Basic Auth (API Key) and OAuth. Nango supports both methods.

### Basic Auth Setup

<Steps>
  <Step title="Create a Gong account">
    If you don't already have one, sign up for a [Gong account](https://www.gong.io/free-trial/).
  </Step>
  <Step title="Obtain API credentials">
    1. Log in to your Gong account.
    2. Navigate to **Company Settings** > **Ecosystem** > **API**.
    3. Click **Get API Key** to generate your API credentials.
    4. You will receive two values:
       - **Access Key**: This is your username in Nango
       - **Access Key Secret**: This is your password in Nango
    5. Make a copy of these credentials as they will be needed when configuring your integration in Nango.
  </Step>
  <Step title="Next">
    Follow the [_Quickstart_](/getting-started/quickstart).
  </Step>
</Steps>

### OAuth Setup

<Steps>
  <Step title="Request a developer account">
    1. Go to [Gong Developer Signup](https://app.gong.io/welcome/developer/sign-up).
    2. Fill out the form with your details and submit.
    3. Wait for approval (this can take up to five working days).
    4. Once approved, you'll receive login credentials for your developer account.
  </Step>
  <Step title="Create a new app">
    1. Log in to your Gong developer account.
    2. Navigate to **Company Settings** > **Ecosystem** > **API**.
    3. Click on the **OAuth** tab.
    4. In the **INTEGRATIONS** tab, click **Create Integration**.
  </Step>
  <Step title="Configure OAuth settings">
    1. Fill in the required app information:
       - **App Name**: Your application's name
       - **Description**: Brief description of your app
       - **Company Website**: Your company's website URL
       - **Redirect URIs**: Add `https://api.nango.dev/oauth/callback`
    2. In the **Required authorization scopes** area, select the scopes that your app needs.
    3. Click **Save** to create your app.
  </Step>
  <Step title="Obtain OAuth credentials">
    1. After creating your app, you'll be provided with:
       - **Client ID**
       - **Client Secret**
    2. Make a copy of these credentials as they will be needed when configuring your integration in Nango.
  </Step>
  <Step title="Submit your app for review (if needed)">
    1. By default, your app will be in "Private" mode and can only be used within your organization.
    2. To make your app available to other Gong customers, you need to publish it to the Gong Collective:
       - Navigate to your app settings
       - Click **Publish to Gong Collective**
       - Complete the required information
       - Submit for review
    3. Wait for Gong's approval before your app can be used by external organizations.
  </Step>
  <Step title="Next">
    Follow the [_Quickstart_](/getting-started/quickstart).
  </Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>


## Useful links

-   [Website](https://www.gong.io/)
-   [Create a Gong account](https://www.gong.io/free-trial/)
-   [API documentation](https://app.gong.io/settings/api/documentation#overview)
-   [Developer signup](https://app.gong.io/welcome/developer/sign-up)
-   [Receive access to the API](https://help.gong.io/docs/receive-access-to-the-api)
-   [Create an app for Gong](https://help.gong.io/docs/create-an-app-for-gong)
-   [OAuth documentation](https://help.gong.io/docs/create-an-app-for-gong#set-up-oauth)
-   [API rate limits](https://app.gong.io/settings/api/documentation#overview)
-   [SCIM API documentation](https://help.gong.io/docs/provision-team-members-from-a-custom-source-scim)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gong.mdx)</Note>



## API gotchas

- End users can generate API keys [on the Gong API page](https://app.gong.io/company/api). They must have the "technical administrator" user role to do this.
- Gong uses BASIC auth for their API, but doesn't call them username and password: `Access Key` is the username in Nango and `Access Key Secret` is the password in Nango.
- [Gong rate-limits](https://app.gong.io/settings/api/documentation#overview) are per second and a total of 10k requests a day.
- By default Gong limits your company's access to the service to 3 API calls per second, and 10,000 API calls per day. You may however change these rates by contacting [help](https://help.gong.io/).
- For OAuth integration, Gong uses `api_base_url_for_customer`, which varies for each customer, as its `base_url` for proxy requests. This parameter is returned in the response of `generate-customer-token`.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/gong.mdx)</Note>

<Card title="Connect to Gong" icon="link" href="/integrations/all/gong/connect" horizontal>
  Guide to connect to Gong API using Nango Connect.
</Card>
